home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_qt.idb / usr / freeware / catman / p_man / cat3 / qimage.Z / qimage
Encoding:
Text File  |  1998-10-28  |  52.2 KB  |  859 lines

  1.  
  2.  
  3.  
  4.      QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))       QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       QImage - Hardware-independent    pixmap representation with
  10.       direct access    to the pixel data
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       #include <qimage.h>
  14.  
  15.     PPPPuuuubbbblllliiiicccc MMMMeeeemmmmbbbbeeeerrrrssss
  16.       QQQQIIIImmmmaaaaggggeeee (((())))
  17.       QQQQIIIImmmmaaaaggggeeee (((( iiiinnnntttt _w_i_d_t_h,,,, iiiinnnntttt _h_e_i_g_h_t,,,, iiiinnnntttt _d_e_p_t_h
  18.       QQQQIIIImmmmaaaaggggeeee (((( ccccoooonnnnsssstttt QQQQSSSSiiiizzzzeeee &&&&,,,, iiiinnnntttt _d_e_p_t_h,,,, iiiinnnntttt _n_u_m_C_o_l_o_r_s====0000,,,, EEEEnnnnddddiiiiaaaannnn
  19.           _b_i_t_O_r_d_e_r
  20.       QQQQIIIImmmmaaaaggggeeee (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr ****    _f_i_l_e_N_a_m_e,,,, ccccoooonnnnsssstttt    cccchhhhaaaarrrr **** _f_o_r_m_a_t====0000    ))))
  21.       QQQQIIIImmmmaaaaggggeeee (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr ****    xxxxppppmmmm[[[[]]]] ))))
  22.       QQQQIIIImmmmaaaaggggeeee (((( ccccoooonnnnsssstttt QQQQIIIImmmmaaaaggggeeee    &&&& ))))
  23.       ~~~~QQQQIIIImmmmaaaaggggeeee ()
  24.       QQQQIIIImmmmaaaaggggeeee&&&& ooooppppeeeerrrraaaattttoooorrrr==== (((( ccccoooonnnnsssstttt QQQQIIIImmmmaaaaggggeeee &&&& ))))
  25.       QQQQIIIImmmmaaaaggggeeee&&&& ooooppppeeeerrrraaaattttoooorrrr==== (((( ccccoooonnnnsssstttt QQQQPPPPiiiixxxxmmmmaaaapppp &&&& ))))
  26.       vvvvooooiiiidddd ddddeeeettttaaaacccchhhh (((())))
  27.       QQQQIIIImmmmaaaaggggeeee ccccooooppppyyyy (((()))) ccccoooonnnnsssstttt
  28.       QQQQIIIImmmmaaaaggggeeee ccccooooppppyyyy ((((    iiiinnnntttt _x,,,, iiiinnnntttt _y,,,, iiiinnnntttt _w
  29.       QQQQIIIImmmmaaaaggggeeee ccccooooppppyyyy ((((    QQQQRRRReeeecccctttt &&&&    )))) ccccoooonnnnsssstttt
  30.       bbbboooooooollll iiiissssNNNNuuuullllllll (((()))) ccccoooonnnnsssstttt
  31.       iiiinnnntttt wwwwiiiiddddtttthhhh (((()))) ccccoooonnnnsssstttt
  32.       iiiinnnntttt hhhheeeeiiiigggghhhhtttt (((())))    ccccoooonnnnsssstttt
  33.       QQQQSSSSiiiizzzzeeee    ssssiiiizzzzeeee (((())))    ccccoooonnnnsssstttt
  34.       QQQQRRRReeeecccctttt    rrrreeeecccctttt (((())))    ccccoooonnnnsssstttt
  35.       iiiinnnntttt ddddeeeepppptttthhhh (((()))) ccccoooonnnnsssstttt
  36.       iiiinnnntttt nnnnuuuummmmCCCCoooolllloooorrrrssss    (((()))) ccccoooonnnnsssstttt
  37.       EEEEnnnnddddiiiiaaaannnn bbbbiiiittttOOOOrrrrddddeeeerrrr (((()))) ccccoooonnnnsssstttt
  38.       QQQQRRRRggggbbbb ccccoooolllloooorrrr (((( iiiinnnntttt iiii )))) ccccoooonnnnsssstttt
  39.       vvvvooooiiiidddd sssseeeettttCCCCoooolllloooorrrr    (((( iiiinnnntttt _i,,,, QQQQRRRRggggbbbb cccc    ))))
  40.       vvvvooooiiiidddd sssseeeettttNNNNuuuummmmCCCCoooolllloooorrrrssss (((( iiiinnnntttt ))))
  41.       bbbboooooooollll hhhhaaaassssAAAAllllpppphhhhaaaaBBBBuuuuffffffffeeeerrrr (((()))) ccccoooonnnnsssstttt
  42.       vvvvooooiiiidddd sssseeeettttAAAAllllpppphhhhaaaaBBBBuuuuffffffffeeeerrrr ((((    bbbboooooooollll ))))
  43.       bbbboooooooollll aaaallllllllGGGGrrrraaaayyyy (((()))) ccccoooonnnnsssstttt
  44.       bbbboooooooollll iiiissssGGGGrrrraaaayyyyssssccccaaaalllleeee (((()))) ccccoooonnnnsssstttt
  45.       uuuucccchhhhaaaarrrr**** bbbbiiiittttssss (((()))) ccccoooonnnnsssstttt
  46.       uuuucccchhhhaaaarrrr**** ssssccccaaaannnnLLLLiiiinnnneeee (((( iiiinnnntttt    )))) ccccoooonnnnsssstttt
  47.       uuuucccchhhhaaaarrrr******** jjjjuuuummmmppppTTTTaaaabbbblllleeee (((()))) ccccoooonnnnsssstttt
  48.       QQQQRRRRggggbbbb****    ccccoooolllloooorrrrTTTTaaaabbbblllleeee (((()))) ccccoooonnnnsssstttt
  49.       iiiinnnntttt nnnnuuuummmmBBBByyyytttteeeessss (((()))) ccccoooonnnnsssstttt
  50.       iiiinnnntttt bbbbyyyytttteeeessssPPPPeeeerrrrLLLLiiiinnnneeee (((()))) ccccoooonnnnsssstttt
  51.       bbbboooooooollll ccccrrrreeeeaaaatttteeee ((((    iiiinnnntttt _w_i_d_t_h,,,, iiiinnnntttt _h_e_i_g_h_t,,,, iiiinnnntttt _d_e_p_t_h
  52.       bbbboooooooollll ccccrrrreeeeaaaatttteeee ((((    ccccoooonnnnsssstttt QQQQSSSSiiiizzzzeeee &&&&,,,, iiiinnnntttt _d_e_p_t_h,,,, iiiinnnntttt _n_u_m_C_o_l_o_r_s====0000,,,,
  53.           EEEEnnnnddddiiiiaaaannnn _b_i_t_O_r_d_e_r
  54.       vvvvooooiiiidddd rrrreeeesssseeeetttt (((())))
  55.       vvvvooooiiiidddd ffffiiiillllllll (((( uuuuiiiinnnntttt ppppiiiixxxxeeeellll ))))
  56.       QQQQIIIImmmmaaaaggggeeee ccccoooonnnnvvvveeeerrrrttttDDDDeeeepppptttthhhh ((((    iiiinnnntttt )))) ccccoooonnnnsssstttt
  57.       QQQQIIIImmmmaaaaggggeeee ccccoooonnnnvvvveeeerrrrttttDDDDeeeepppptttthhhhWWWWiiiitttthhhhPPPPaaaalllleeeetttttttteeee (((( iiiinnnntttt,,,,    QQQQRRRRggggbbbb **** _p,,,, iiiinnnntttt _p_c,,,, iiiinnnntttt
  58.           _c_f
  59.       QQQQIIIImmmmaaaaggggeeee ccccoooonnnnvvvveeeerrrrttttDDDDeeeepppptttthhhh ((((    iiiinnnntttt,,,, iiiinnnntttt ccccoooonnnnvvvveeeerrrrssssiiiioooonnnn____ffffllllaaaaggggssss )))) ccccoooonnnnsssstttt
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 9/22/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))       QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))
  71.  
  72.  
  73.  
  74.       QQQQIIIImmmmaaaaggggeeee ccccoooonnnnvvvveeeerrrrttttBBBBiiiittttOOOOrrrrddddeeeerrrr (((( EEEEnnnnddddiiiiaaaannnn )))) ccccoooonnnnsssstttt
  75.       QQQQIIIImmmmaaaaggggeeee ssssmmmmooooooootttthhhhSSSSccccaaaalllleeee (((( iiiinnnntttt _w_i_d_t_h,,,, iiiinnnntttt hhhheeeeiiiigggghhhhtttt )))) ccccoooonnnnsssstttt
  76.       QQQQIIIImmmmaaaaggggeeee ccccrrrreeeeaaaatttteeeeAAAAllllpppphhhhaaaaMMMMaaaasssskkkk (((( iiiinnnntttt ccccoooonnnnvvvveeeerrrrssssiiiioooonnnn____ffffllllaaaaggggssss    )))) ccccoooonnnnsssstttt
  77.       QQQQIIIImmmmaaaaggggeeee ccccrrrreeeeaaaatttteeeeHHHHeeeeuuuurrrriiiissssttttiiiiccccMMMMaaaasssskkkk (((( bbbboooooooollll _c_l_i_p_T_i_g_h_t====TTTTRRRRUUUUEEEE )))) ccccoooonnnnsssstttt
  78.       bbbboooooooollll llllooooaaaadddd (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** _f_i_l_e_N_a_m_e,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** _f_o_r_m_a_t====0000 ))))
  79.       bbbboooooooollll llllooooaaaaddddFFFFrrrroooommmmDDDDaaaattttaaaa (((( ccccoooonnnnsssstttt uuuucccchhhhaaaarrrr **** _b_u_f,,,, uuuuiiiinnnntttt _l_e_n,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr
  80.           ****    _f_o_r_m_a_t
  81.       bbbboooooooollll llllooooaaaaddddFFFFrrrroooommmmDDDDaaaattttaaaa (((( QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy _d_a_t_a,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr **** _f_o_r_m_a_t====0000 ))))
  82.       bbbboooooooollll ssssaaaavvvveeee (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** _f_i_l_e_N_a_m_e,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** ffffoooorrrrmmmmaaaatttt ))))
  83.           ccccoooonnnnsssstttt
  84.       bbbboooooooollll vvvvaaaalllliiiidddd (((( iiiinnnntttt _x,,,, iiiinnnntttt yyyy )))) ccccoooonnnnsssstttt
  85.       iiiinnnntttt ppppiiiixxxxeeeellllIIIInnnnddddeeeexxxx (((( iiiinnnntttt _x,,,, iiiinnnntttt yyyy    )))) ccccoooonnnnsssstttt
  86.       QQQQRRRRggggbbbb ppppiiiixxxxeeeellll (((( iiiinnnntttt _x,,,, iiiinnnntttt yyyy )))) ccccoooonnnnsssstttt
  87.       vvvvooooiiiidddd sssseeeettttPPPPiiiixxxxeeeellll    (((( iiiinnnntttt _x,,,, iiiinnnntttt _y,,,,    uuuuiiiinnnntttt iiiinnnnddddeeeexxxx____oooorrrr____rrrrggggbbbb ))))
  88.  
  89.     SSSSttttaaaattttiiiicccc PPPPuuuubbbblllliiiicccc MMMMeeeemmmmbbbbeeeerrrrssss
  90.       EEEEnnnnddddiiiiaaaannnn ssssyyyysssstttteeeemmmmBBBBiiiittttOOOOrrrrddddeeeerrrr    (((())))
  91.       EEEEnnnnddddiiiiaaaannnn ssssyyyysssstttteeeemmmmBBBByyyytttteeeeOOOOrrrrddddeeeerrrr (((())))
  92.       ccccoooonnnnsssstttt    cccchhhhaaaarrrr**** iiiimmmmaaaaggggeeeeFFFFoooorrrrmmmmaaaatttt (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffiiiilllleeeeNNNNaaaammmmeeee ))))
  93.       QQQQSSSSttttrrrrLLLLiiiisssstttt iiiinnnnppppuuuuttttFFFFoooorrrrmmmmaaaattttssss    (((())))
  94.       QQQQSSSSttttrrrrLLLLiiiisssstttt oooouuuuttttppppuuuuttttFFFFoooorrrrmmmmaaaattttssss (((())))
  95.  
  96.      RRRREEEELLLLAAAATTTTEEEEDDDD FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  97.       (Note    that these are not member functions.)
  98.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&&    ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm    &&&& _s,,,, ccccoooonnnnsssstttt QQQQIIIImmmmaaaaggggeeee &&&&
  99.           _i_m_a_g_e))))
  100.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&&    ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm    &&&& _s,,,, QQQQIIIImmmmaaaaggggeeee &&&& _i_m_a_g_e))))
  101.  
  102.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  103.       The QImage class provides a hardware-independent pixmap
  104.       representation with direct access to the pixel data.
  105.  
  106.       It is    one of the two classes Qt provides for dealing with
  107.       images, the other being QPixmap. QImage is designed and
  108.       optimized for    I/O and    for direct pixel access/manipulation,
  109.       QPixmap is designed and optimized for    drawing. There are
  110.       (slow) functions to convert between QImage and QPixmp;
  111.       QPixmap::convertToImage() and    QPixmap::convertFromImage().
  112.  
  113.       An image has the parameters width, height and    depth (bits
  114.       per pixel, bpp), a color table and the actual    pixels.    QImage
  115.       supports 1-bpp, 8-bpp    and 32-bpp image data. 1-bpp and 8-bpp
  116.       images use a color lookup table; the pixel value is a    color
  117.       table    index.
  118.  
  119.       32-bpp images    encode an RGB value in 24 bits and ignore the
  120.       color    table. The most    significant byte is used for the alpha
  121.       buffer.
  122.  
  123.       An entry in the color    table is an RGB    triplet    encoded    as
  124.       uint.    Use the    qRed, qGreen and qBlue functions (qcolor.h) to
  125.       access the components, and qRgb to make an RGB triplet (see
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 9/22/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))       QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))
  137.  
  138.  
  139.  
  140.       the QColor class documentation).
  141.  
  142.       1-bpp    (monochrome) images have a color table with maximum 2
  143.       colors. There    are two    different formats; big endian (MSB
  144.       first) or little endian (LSB first) bit order. To access a
  145.       single bit, you will have to do some bitshifts:
  146.  
  147.           QImage image;
  148.         // sets    bit at (x,y) to    1
  149.           if ( image.bitOrder() == QImage::LittleEndian )
  150.           *(image.scanLine(y) +    (x >> 3)) |= 1 << (x & 7);
  151.           else
  152.           *(image.scanLine(y) +    (x >> 3)) |= 1 << (7 -(x & 7));
  153.  
  154.       If this looks    complicated, it    might be a good    idea to
  155.       convert the 1-bpp image to an    8-bpp image using
  156.       convertDepth().
  157.  
  158.       8-bpp    images are much    easier to work with than 1-bpp images
  159.       because they have a single byte per pixel:
  160.  
  161.           QImage image;
  162.         // set entry 19    in the color table to yellow
  163.           image.setColor( 19, qRgb(255,255,0) );
  164.         // set 8 bit pixel at (x,y) to value yellow (in    color table)
  165.           *(image.scanLine(y) + x) = 19;
  166.  
  167.       32-bpp images    ignore the color table,    instead    each pixel
  168.       contains the RGB triplet. 24 bits contain the    RGB value and
  169.       the most significant byte is reserved    for the    alpha buffer.
  170.  
  171.           QImage image;
  172.         // sets    32 bit pixel at    (x,y) to yellow.
  173.           uint *p =    (uint *)image.scanLine(y) + x;
  174.           *p = qRgb(255,255,0);
  175.  
  176.       The scanlines    are 32-bit aligned for all depths.
  177.  
  178.       The QImage class uses    explicit sharing, similar to that of
  179.       QArray and QString.
  180.  
  181.       See also: QImageIO, QPixmap and Shared Classes
  182.  
  183.       Examples:  qtimage/qtimage.cpp desktop/desktop.cpp
  184.       qmag/qmag.cpp
  185.  
  186.      MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  187.      QQQQIIIImmmmaaaaggggeeee::::::::QQQQIIIImmmmaaaaggggeeee (((())))
  188.       Constructs a null image.
  189.  
  190.       See also: isNull().
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 9/22/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))       QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))
  203.  
  204.  
  205.  
  206.      QQQQIIIImmmmaaaaggggeeee::::::::QQQQIIIImmmmaaaaggggeeee (((( ccccoooonnnnsssstttt QQQQIIIImmmmaaaaggggeeee &&&& iiiimmmmaaaaggggeeee ))))
  207.       Constructs a shallow copy of _i_m_a_g_e.
  208.  
  209.      QQQQIIIImmmmaaaaggggeeee::::::::QQQQIIIImmmmaaaaggggeeee (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffiiiilllleeeeNNNNaaaammmmeeee,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** ffffoooorrrrmmmmaaaatttt====0000 ))))
  210.       Constructs an    image from loading _f_i_l_e_N_a_m_e and    an optional
  211.       _f_o_r_m_a_t.
  212.  
  213.       See also: load().
  214.  
  215.      QQQQIIIImmmmaaaaggggeeee::::::::QQQQIIIImmmmaaaaggggeeee (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** xxxxppppmmmm[[[[]]]] ))))
  216.       Constructs an    image from _x_p_m,    which must be a    valid XPM
  217.       image.
  218.  
  219.       Errors are silently ignored.
  220.  
  221.      QQQQIIIImmmmaaaaggggeeee::::::::QQQQIIIImmmmaaaaggggeeee (((( iiiinnnntttt wwww,,,, iiiinnnntttt hhhh,,,, iiiinnnntttt    ddddeeeepppptttthhhh,,,, iiiinnnntttt nnnnuuuummmmCCCCoooolllloooorrrrssss====0000,,,,    EEEEnnnnddddiiiiaaaannnn
  222.       bbbbiiiittttOOOOrrrrddddeeeerrrr====IIIIggggnnnnoooorrrreeeeEEEEnnnnddddiiiiaaaannnn    ))))
  223.       Constructs an    image with _w width, _h height, _d_e_p_t_h bits per
  224.       pixel, _n_u_m_C_o_l_o_r_s colors and bit order    _b_i_t_O_r_d_e_r.
  225.  
  226.       Using    this constructor is the    same as    first constructing a
  227.       null image and then calling the create() function.
  228.  
  229.       See also: create().
  230.  
  231.      QQQQIIIImmmmaaaaggggeeee::::::::QQQQIIIImmmmaaaaggggeeee (((( ccccoooonnnnsssstttt QQQQSSSSiiiizzzzeeee &&&&,,,, iiiinnnntttt ddddeeeepppptttthhhh,,,,    iiiinnnntttt nnnnuuuummmmCCCCoooolllloooorrrrssss====0000,,,,
  232.       EEEEnnnnddddiiiiaaaannnn bbbbiiiittttOOOOrrrrddddeeeerrrr====IIIIggggnnnnoooorrrreeeeEEEEnnnnddddiiiiaaaannnn ))))
  233.       This is an overloaded    member function, provided for
  234.       convenience. It differs from the above function only in what
  235.       argument(s) it accepts.
  236.  
  237.      QQQQIIIImmmmaaaaggggeeee::::::::~~~~QQQQIIIImmmmaaaaggggeeee (((())))
  238.       Destroys the image and cleans    up.
  239.  
  240.      bbbboooooooollll QQQQIIIImmmmaaaaggggeeee::::::::aaaallllllllGGGGrrrraaaayyyy (((()))) ccccoooonnnnsssstttt
  241.       Returns TRUE if all the colors in the    image are shades of
  242.       gray,    that is    their R, G, and    B components are equal.    This
  243.       function is slow for large 32-bit images.
  244.  
  245.      QQQQIIIImmmmaaaaggggeeee::::::::EEEEnnnnddddiiiiaaaannnn QQQQIIIImmmmaaaaggggeeee::::::::bbbbiiiittttOOOOrrrrddddeeeerrrr(((()))) ccccoooonnnnsssstttt
  246.       Returns the bit order    for the    image.
  247.  
  248.       If it    is a 1-bpp image, this function    returns    either
  249.       QImage::BigEndian or QImage::LittleEndian.
  250.  
  251.       If it    is not a 1-bpp image, this function returns
  252.       QImage::IgnoreEndian.
  253.  
  254.       See also: depth().
  255.  
  256.      uuuucccchhhhaaaarrrr **** QQQQIIIImmmmaaaaggggeeee::::::::bbbbiiiittttssss (((()))) ccccoooonnnnsssstttt
  257.       Returns a pointer to the first pixel data. Equivalent    to
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 9/22/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))       QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))
  269.  
  270.  
  271.  
  272.       scanLine(0).
  273.  
  274.       See also: scanLine().
  275.  
  276.      iiiinnnntttt QQQQIIIImmmmaaaaggggeeee::::::::bbbbyyyytttteeeessssPPPPeeeerrrrLLLLiiiinnnneeee (((()))) ccccoooonnnnsssstttt
  277.       Returns the number of    bytes per image    scanline. This is
  278.       equivalent to    numBytes()/height().
  279.  
  280.      QQQQRRRRggggbbbb QQQQIIIImmmmaaaaggggeeee::::::::ccccoooolllloooorrrr    (((( iiiinnnntttt iiii    )))) ccccoooonnnnsssstttt
  281.       Returns the color in the color table at index    _i.
  282.  
  283.       A color value    is an RGB triplet. Use the QRED, QGREEN    and
  284.       QBLUE    functions (defined in qcolor.h)    to get the color value
  285.       components.
  286.  
  287.       See also: setColor() and QColor.
  288.  
  289.      QQQQRRRRggggbbbb **** QQQQIIIImmmmaaaaggggeeee::::::::ccccoooolllloooorrrrTTTTaaaabbbblllleeee (((()))) ccccoooonnnnsssstttt
  290.       Returns a pointer to the color table.
  291.  
  292.      QQQQIIIImmmmaaaaggggeeee QQQQIIIImmmmaaaaggggeeee::::::::ccccoooonnnnvvvveeeerrrrttttBBBBiiiittttOOOOrrrrddddeeeerrrr (((( EEEEnnnnddddiiiiaaaannnn bbbbiiiittttOOOOrrrrddddeeeerrrr ))))    ccccoooonnnnsssstttt
  293.       Converts the bit order of the    image to _b_i_t_O_r_d_e_r and returns
  294.       the converted    image.
  295.  
  296.       Returns *this    if the _b_i_t_O_r_d_e_r    is equal to the    image bit
  297.       order, or a null image if this image cannot be converted.
  298.  
  299.       See also: bitOrder() and setBitOrder().
  300.  
  301.      QQQQIIIImmmmaaaaggggeeee QQQQIIIImmmmaaaaggggeeee::::::::ccccoooonnnnvvvveeeerrrrttttDDDDeeeepppptttthhhh (((( iiiinnnntttt ddddeeeepppptttthhhh,,,, iiiinnnntttt ccccoooonnnnvvvveeeerrrrssssiiiioooonnnn____ffffllllaaaaggggssss ))))
  302.       ccccoooonnnnsssstttt
  303.       Converts the depth (bpp) of the image    to _d_e_p_t_h and returns
  304.       the converted    image. The original image is left undisturbed.
  305.  
  306.       The _d_e_p_t_h argument must be 1,    8 or 32.
  307.  
  308.       See QPixmap::convertFromImage    for a description of the
  309.       _c_o_n_v_e_r_s_i_o_n__f_l_a_g_s argument.
  310.  
  311.       Returns *this    if _d_e_p_t_h is equal to the image depth, or a
  312.       null image if    this image cannot be converted.
  313.  
  314.       See also: depth() and    isNull().
  315.  
  316.      QQQQIIIImmmmaaaaggggeeee QQQQIIIImmmmaaaaggggeeee::::::::ccccoooonnnnvvvveeeerrrrttttDDDDeeeepppptttthhhh (((( iiiinnnntttt ddddeeeepppptttthhhh )))) ccccoooonnnnsssstttt
  317.       This is an overloaded    member function, provided for
  318.       convenience. It differs from the above function only in what
  319.       argument(s) it accepts.
  320.  
  321.      QQQQIIIImmmmaaaaggggeeee QQQQIIIImmmmaaaaggggeeee::::::::ccccoooonnnnvvvveeeerrrrttttDDDDeeeepppptttthhhhWWWWiiiitttthhhhPPPPaaaalllleeeetttttttteeee (((( iiiinnnntttt dddd,,,, QQQQRRRRggggbbbb **** ppppaaaalllleeeetttttttteeee,,,,
  322.       iiiinnnntttt ppppaaaalllleeeetttttttteeee____ccccoooouuuunnnntttt,,,, iiiinnnntttt ccccoooonnnnvvvveeeerrrrssssiiiioooonnnn____ffffllllaaaaggggssss====0000 )))) ccccoooonnnnsssstttt
  323.       Note:    currently no closest-color search is made. If colors
  324.  
  325.  
  326.  
  327.      Page 5                         (printed 9/22/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))       QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))
  335.  
  336.  
  337.  
  338.       are found that are not in the    palette, the palette may not
  339.       be used at all. This result should not be considered valid,
  340.       as it    may change in future implementations.
  341.  
  342.       Currently inefficient    for non    32-bit images.
  343.  
  344.      QQQQIIIImmmmaaaaggggeeee QQQQIIIImmmmaaaaggggeeee::::::::ccccooooppppyyyy (((()))) ccccoooonnnnsssstttt
  345.       Returns a deep copy of the image.
  346.  
  347.      QQQQIIIImmmmaaaaggggeeee QQQQIIIImmmmaaaaggggeeee::::::::ccccooooppppyyyy (((( iiiinnnntttt xxxx,,,, iiiinnnntttt yyyy,,,, iiiinnnntttt wwww,,,,    iiiinnnntttt hhhh,,,, iiiinnnntttt
  348.       ccccoooonnnnvvvveeeerrrrssssiiiioooonnnn____ffffllllaaaaggggssss====0000 )))) ccccoooonnnnsssstttt
  349.       Returns a deep copy of a sub-area of the image.
  350.  
  351.       See also: bitBlt().
  352.  
  353.      QQQQIIIImmmmaaaaggggeeee QQQQIIIImmmmaaaaggggeeee::::::::ccccooooppppyyyy (((( QQQQRRRReeeecccctttt &&&& rrrr )))) ccccoooonnnnsssstttt
  354.       This is an overloaded    member function, provided for
  355.       convenience. It differs from the above function only in what
  356.       argument(s) it accepts.
  357.  
  358.      bbbboooooooollll QQQQIIIImmmmaaaaggggeeee::::::::ccccrrrreeeeaaaatttteeee (((( iiiinnnntttt wwwwiiiiddddtttthhhh,,,, iiiinnnntttt hhhheeeeiiiigggghhhhtttt,,,, iiiinnnntttt ddddeeeepppptttthhhh,,,, iiiinnnntttt
  359.       nnnnuuuummmmCCCCoooolllloooorrrrssss====0000,,,, EEEEnnnnddddiiiiaaaannnn bbbbiiiittttOOOOrrrrddddeeeerrrr====IIIIggggnnnnoooorrrreeeeEEEEnnnnddddiiiiaaaannnn ))))
  360.       Sets the image width,    height,    depth, number of colors    and
  361.       bit order. Returns TRUE if successful, or FALSE if the
  362.       parameters are incorrect or if memory    cannot be allocated.
  363.  
  364.       The _w_i_d_t_h and    _h_e_i_g_h_t is limited to 32767. _d_e_p_t_h must be 1, 8
  365.       or 32. If _d_e_p_t_h is 1,    then _b_i_t_O_r_d_e_r must be set to either
  366.       QImage::LittleEndian or QImage::BigEndian. For other depths,
  367.       _b_i_t_O_r_d_e_r must    be QImage::IgnoreEndian.
  368.  
  369.       This function    allocates a color table    and a buffer for the
  370.       image    data. The image    data is    not initialized.
  371.  
  372.       The image buffer is allocated    as a single block that
  373.       consists of a    table of scanline pointers (jumpTable()) and
  374.       the image data (bits()).
  375.  
  376.       See also: width(), height(), depth(),    numColors(),
  377.       bitOrder(), jumpTable(), scanLine(), bits(), bytesPerLine()
  378.       and numBytes().
  379.  
  380.      bbbboooooooollll QQQQIIIImmmmaaaaggggeeee::::::::ccccrrrreeeeaaaatttteeee (((( ccccoooonnnnsssstttt QQQQSSSSiiiizzzzeeee &&&&,,,, iiiinnnntttt ddddeeeepppptttthhhh,,,, iiiinnnntttt nnnnuuuummmmCCCCoooolllloooorrrrssss====0000,,,,
  381.       EEEEnnnnddddiiiiaaaannnn bbbbiiiittttOOOOrrrrddddeeeerrrr====IIIIggggnnnnoooorrrreeeeEEEEnnnnddddiiiiaaaannnn ))))
  382.       This is an overloaded    member function, provided for
  383.       convenience. It differs from the above function only in what
  384.       argument(s) it accepts.
  385.  
  386.      QQQQIIIImmmmaaaaggggeeee QQQQIIIImmmmaaaaggggeeee::::::::ccccrrrreeeeaaaatttteeeeAAAAllllpppphhhhaaaaMMMMaaaasssskkkk (((( iiiinnnntttt ccccoooonnnnvvvveeeerrrrssssiiiioooonnnn____ffffllllaaaaggggssss )))) ccccoooonnnnsssstttt
  387.       Builds and returns a 1-bpp mask from the alpha buffer    in
  388.       this image. Returns a    null image if alpha buffer mode    is
  389.       disabled.
  390.  
  391.  
  392.  
  393.      Page 6                         (printed 9/22/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))       QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))
  401.  
  402.  
  403.  
  404.       See QPixmap::convertFromImage    for a description of the
  405.       _c_o_n_v_e_r_s_i_o_n__f_l_a_g_s argument.
  406.  
  407.       The returned image has little-endian bit order, which    you
  408.       can convert to big-endianness    using convertBitOrder().
  409.  
  410.      QQQQIIIImmmmaaaaggggeeee QQQQIIIImmmmaaaaggggeeee::::::::ccccrrrreeeeaaaatttteeeeHHHHeeeeuuuurrrriiiissssttttiiiiccccMMMMaaaasssskkkk    (((( bbbboooooooollll cccclllliiiippppTTTTiiiigggghhhhtttt====TTTTRRRRUUUUEEEE ))))    ccccoooonnnnsssstttt
  411.       Creates and returns a    1-bpp heuristic    mask for this image.
  412.       It works by selecting    a color    from one of the    corners, then
  413.       chipping away    pixels of that color, starting at all the
  414.       edges.
  415.  
  416.       The four corners vote    over which color is to be masked away.
  417.       In case of a draw (this generally means that this function
  418.       is not applicable to the image) the voting results are
  419.       undocumented.
  420.  
  421.       The returned image has little-endian bit order, which    you
  422.       can convert to big-endianness    using convertBitOrder().
  423.  
  424.       This function    disregards the alpha buffer.
  425.  
  426.      iiiinnnntttt QQQQIIIImmmmaaaaggggeeee::::::::ddddeeeepppptttthhhh (((()))) ccccoooonnnnsssstttt
  427.       Returns the depth of the image.
  428.  
  429.       The image depth is the number    of bits    used to    encode a
  430.       single pixel,    also called bits per pixel (bpp) or bit    planes
  431.       of an    image.
  432.  
  433.       The supported    depths are 1, 8    and 32.
  434.  
  435.      vvvvooooiiiidddd QQQQIIIImmmmaaaaggggeeee::::::::ddddeeeettttaaaacccchhhh (((())))
  436.       Detaches from    shared image data and makes sure that this
  437.       image    is the only one    referring the data.
  438.  
  439.       If multiple images share common data,    this image makes a
  440.       copy of the data and detaches    itself from the    sharing
  441.       mechanism. Nothing is    done if    there is just a    single
  442.       reference.
  443.  
  444.      vvvvooooiiiidddd QQQQIIIImmmmaaaaggggeeee::::::::ffffiiiillllllll (((( uuuuiiiinnnntttt ppppiiiixxxxeeeellll ))))
  445.       Fills    the entire image with the pixel    value _p_i_x_e_l.
  446.  
  447.       If the depth of this image is    1, only    the lowest bit is
  448.       used.    If you say fill(0), fill(2) etc., the image is filled
  449.       with 0s. If you say fill(1), fill(3) etc., the image is
  450.       filled with 1s. If the depth is 8, the lowest    8 bits are
  451.       used.
  452.  
  453.       If the depth is 32 and the image has no alpha    buffer,    the
  454.       _p_i_x_e_l    value is written to each pixel in the image. If    the
  455.       image    has an alpha buffer, only the 24 RGB bits are set and
  456.  
  457.  
  458.  
  459.      Page 7                         (printed 9/22/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))       QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))
  467.  
  468.  
  469.  
  470.       the upper 8 bits (alpha value) are left unchanged.
  471.  
  472.      bbbboooooooollll QQQQIIIImmmmaaaaggggeeee::::::::hhhhaaaassssAAAAllllpppphhhhaaaaBBBBuuuuffffffffeeeerrrr (((()))) ccccoooonnnnsssstttt
  473.       Returns TRUE if alpha    buffer mode is enabled,    otherwise
  474.       FALSE.
  475.  
  476.       See also: setAlphaBuffer().
  477.  
  478.      iiiinnnntttt QQQQIIIImmmmaaaaggggeeee::::::::hhhheeeeiiiigggghhhhtttt    (((()))) ccccoooonnnnsssstttt
  479.       Returns the height of    the image.
  480.  
  481.       See also: width(), size() and    rect().
  482.  
  483.      ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** QQQQIIIImmmmaaaaggggeeee::::::::iiiimmmmaaaaggggeeeeFFFFoooorrrrmmmmaaaatttt ((((    ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffiiiilllleeeeNNNNaaaammmmeeee ))))
  484.       [[[[ssssttttaaaattttiiiicccc]]]]
  485.       Returns a string that    specifies the image format of the file
  486.       _f_i_l_e_N_a_m_e, or null if the file    cannot be read or if the
  487.       format cannot    be recognized.
  488.  
  489.       The QImageIO documentation lists the guaranteed supported
  490.       image    formats, or use    the QImage::inputFormats()
  491.       QImage::outputFormats() to get lists that include installed
  492.       formats.
  493.  
  494.       See also: load() and save().
  495.  
  496.      QQQQSSSSttttrrrrLLLLiiiisssstttt QQQQIIIImmmmaaaaggggeeee::::::::iiiinnnnppppuuuuttttFFFFoooorrrrmmmmaaaattttssss (((()))) [[[[ssssttttaaaattttiiiicccc]]]]
  497.       Returns a list of image formats which    are supported for
  498.       image    input.
  499.  
  500.      bbbboooooooollll QQQQIIIImmmmaaaaggggeeee::::::::iiiissssGGGGrrrraaaayyyyssssccccaaaalllleeee (((()))) ccccoooonnnnsssstttt
  501.       Returns TRUE if the image is allGray(), _a_n_d if the image is
  502.       32-bpp or a 256-color    8-bpp image for    which color(i) is
  503.       QRgb(i,i,i).
  504.  
  505.      bbbboooooooollll QQQQIIIImmmmaaaaggggeeee::::::::iiiissssNNNNuuuullllllll (((()))) ccccoooonnnnsssstttt
  506.       Returns TRUE if it is    a null image.
  507.  
  508.       A null image has all parameters set to zero and no allocated
  509.       data.
  510.  
  511.       Examples:  qtimage/qtimage.cpp
  512.  
  513.      uuuucccchhhhaaaarrrr ******** QQQQIIIImmmmaaaaggggeeee::::::::jjjjuuuummmmppppTTTTaaaabbbblllleeee    (((()))) ccccoooonnnnsssstttt
  514.       Returns a pointer to the scanline pointer table.
  515.  
  516.       This is the beginning    of the data block for the image.
  517.  
  518.      bbbboooooooollll QQQQIIIImmmmaaaaggggeeee::::::::llllooooaaaadddd (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffiiiilllleeeeNNNNaaaammmmeeee,,,,    ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffoooorrrrmmmmaaaatttt====0000
  519.       ))))
  520.       Loads    an image from the file _f_i_l_e_N_a_m_e. Returns TRUE if
  521.       successful, or FALSE if the image could not be loaded.
  522.  
  523.  
  524.  
  525.      Page 8                         (printed 9/22/98)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))       QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))
  533.  
  534.  
  535.  
  536.       If _f_o_r_m_a_t is specified, the loader attempts to read the
  537.       image    using the specified format. If _f_o_r_m_a_t is not specified
  538.       (default), the loader    reads a    few bytes from the header to
  539.       guess    the file format.
  540.  
  541.       The QImageIO documentation lists the supported image formats
  542.       and explains how to add extra    formats.
  543.  
  544.       See also: loadFromData(), save(), imageFormat(),
  545.       QPixmap::load() and QImageIO.
  546.  
  547.      bbbboooooooollll QQQQIIIImmmmaaaaggggeeee::::::::llllooooaaaaddddFFFFrrrroooommmmDDDDaaaattttaaaa (((( ccccoooonnnnsssstttt uuuucccchhhhaaaarrrr **** bbbbuuuuffff,,,, uuuuiiiinnnntttt lllleeeennnn,,,, ccccoooonnnnsssstttt
  548.       cccchhhhaaaarrrr **** ffffoooorrrrmmmmaaaatttt====0000 ))))
  549.       Loads    an image from the binary data in _b_u_f (_l_e_n bytes).
  550.       Returns TRUE if successful, or FALSE if the image could not
  551.       be loaded.
  552.  
  553.       If _f_o_r_m_a_t is specified, the loader attempts to read the
  554.       image    using the specified format. If _f_o_r_m_a_t is not specified
  555.       (default), the loader    reads a    few bytes from the header to
  556.       guess    the file format.
  557.  
  558.       The QImageIO documentation lists the supported image formats
  559.       and explains how to add extra    formats.
  560.  
  561.       See also: load(), save(), imageFormat(),
  562.       QPixmap::loadFromData() and QImageIO.
  563.  
  564.      bbbboooooooollll QQQQIIIImmmmaaaaggggeeee::::::::llllooooaaaaddddFFFFrrrroooommmmDDDDaaaattttaaaa (((( QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy bbbbuuuuffff,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffoooorrrrmmmmaaaatttt====0000
  565.       ))))
  566.       This is an overloaded    member function, provided for
  567.       convenience. It differs from the above function only in what
  568.       argument(s) it accepts.
  569.  
  570.      iiiinnnntttt QQQQIIIImmmmaaaaggggeeee::::::::nnnnuuuummmmBBBByyyytttteeeessss (((()))) ccccoooonnnnsssstttt
  571.       Returns the number of    bytes occupied by the image data.
  572.  
  573.       See also: bytesPerLine().
  574.  
  575.      iiiinnnntttt QQQQIIIImmmmaaaaggggeeee::::::::nnnnuuuummmmCCCCoooolllloooorrrrssss (((()))) ccccoooonnnnsssstttt
  576.       Returns the size of the color    table for the image.
  577.  
  578.       Notice that numColors() returns 0 for    32-bpp images, since
  579.       these    images do not use color    tables,    but instead encode
  580.       pixel    values as RGB triplets.
  581.  
  582.      QQQQIIIImmmmaaaaggggeeee &&&& QQQQIIIImmmmaaaaggggeeee::::::::ooooppppeeeerrrraaaattttoooorrrr====    (((( ccccoooonnnnsssstttt    QQQQPPPPiiiixxxxmmmmaaaapppp    &&&& ppppiiiixxxxmmmmaaaapppp ))))
  583.       Sets the image bits to the _p_i_x_m_a_p contents and returns a
  584.       reference to the image.
  585.  
  586.       If the image shares data with    other images, it will first
  587.       dereference the shared data.
  588.  
  589.  
  590.  
  591.      Page 9                         (printed 9/22/98)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))       QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))
  599.  
  600.  
  601.  
  602.       Makes    a call to QPixmap::convertToImage().
  603.  
  604.      QQQQIIIImmmmaaaaggggeeee &&&& QQQQIIIImmmmaaaaggggeeee::::::::ooooppppeeeerrrraaaattttoooorrrr====    (((( ccccoooonnnnsssstttt    QQQQIIIImmmmaaaaggggeeee &&&& iiiimmmmaaaaggggeeee ))))
  605.       Assigns a shallow copy of _i_m_a_g_e to this image    and returns a
  606.       reference to this image.
  607.  
  608.       See also: copy().
  609.  
  610.      QQQQSSSSttttrrrrLLLLiiiisssstttt QQQQIIIImmmmaaaaggggeeee::::::::oooouuuuttttppppuuuuttttFFFFoooorrrrmmmmaaaattttssss (((()))) [[[[ssssttttaaaattttiiiicccc]]]]
  611.       Returns a list of image formats which    are supported for
  612.       image    output.
  613.  
  614.      QQQQRRRRggggbbbb QQQQIIIImmmmaaaaggggeeee::::::::ppppiiiixxxxeeeellll    (((( iiiinnnntttt xxxx,,,, iiiinnnntttt yyyy )))) ccccoooonnnnsssstttt
  615.       Returns the actual color of the pixel    at the given
  616.       coordinates.
  617.  
  618.       If (x,y) is not on the image,    the results are    undefined.
  619.  
  620.       Examples:  qmag/qmag.cpp
  621.  
  622.      iiiinnnntttt QQQQIIIImmmmaaaaggggeeee::::::::ppppiiiixxxxeeeellllIIIInnnnddddeeeexxxx (((( iiiinnnntttt xxxx,,,, iiiinnnntttt yyyy )))) ccccoooonnnnsssstttt
  623.       Returns the pixel index at the given coordinates.
  624.  
  625.       If (x,y) is not valid, or if the image is not    a paletted
  626.       image    (depth() > 8), the results are undefined.
  627.  
  628.      QQQQRRRReeeecccctttt QQQQIIIImmmmaaaaggggeeee::::::::rrrreeeecccctttt    (((()))) ccccoooonnnnsssstttt
  629.       Returns the enclosing    rectangle (0,0,width(),height()) of
  630.       the image.
  631.  
  632.       See also: width(), height() and size().
  633.  
  634.      vvvvooooiiiidddd QQQQIIIImmmmaaaaggggeeee::::::::rrrreeeesssseeeetttt    (((())))
  635.       Resets all image parameters and deallocates the image    data.
  636.  
  637.       Examples:  qtimage/qtimage.cpp
  638.  
  639.      bbbboooooooollll QQQQIIIImmmmaaaaggggeeee::::::::ssssaaaavvvveeee (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffiiiilllleeeeNNNNaaaammmmeeee,,,,    ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffoooorrrrmmmmaaaatttt ))))
  640.       ccccoooonnnnsssstttt
  641.       Saves    the image to the file _f_i_l_e_N_a_m_e,    using the image    file
  642.       format _f_o_r_m_a_t. Returns TRUE if successful, or    FALSE if the
  643.       image    could not be saved.
  644.  
  645.       See also: load(), loadFromData(), imageFormat(),
  646.       QPixmap::save() and QImageIO.
  647.  
  648.      uuuucccchhhhaaaarrrr **** QQQQIIIImmmmaaaaggggeeee::::::::ssssccccaaaannnnLLLLiiiinnnneeee ((((    iiiinnnntttt iiii ))))    ccccoooonnnnsssstttt
  649.       Returns a pointer to the pixel data at the _i'_t_h scanline.
  650.  
  651.       The scanline data is aligned on a 32-bit boundary.
  652.  
  653.       WWWWaaaarrrrnnnniiiinnnngggg:::: If you are accessing    32-bpp image data, cast    the
  654.  
  655.  
  656.  
  657.      Page 10                         (printed 9/22/98)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))       QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))
  665.  
  666.  
  667.  
  668.       returned pointer to QRgb* (QRgb has a    32 bit size) and use
  669.       it to    read/write the pixel value. You    cannot use the uchar*
  670.       pointer directly, because the    pixel format depends on    the
  671.       byte order on    the underlying platform. Hint: use qRed() and
  672.       friends (qcolor.h) to    access the pixels.
  673.  
  674.       See also: bits().
  675.  
  676.       Examples:  desktop/desktop.cpp
  677.  
  678.      vvvvooooiiiidddd QQQQIIIImmmmaaaaggggeeee::::::::sssseeeettttAAAAllllpppphhhhaaaaBBBBuuuuffffffffeeeerrrr (((( bbbboooooooollll    eeeennnnaaaabbbblllleeee ))))
  679.       Enables alpha    buffer mode if _e_n_a_b_l_e is TRUE, otherwise
  680.       disables it. The default setting is disabled.
  681.  
  682.       An 8-bpp image has 8 bit pixels. A pixel is an index into
  683.       the color table, which contains 32-bit color values. In a
  684.       32-bpp image,    the 32 bit pixels are the color    values.
  685.  
  686.       This 32 bit value is encoded as follows: The lower 24    bits
  687.       are used for the red,    green and blue components. The upper 8
  688.       bits contain the alpha component.
  689.  
  690.       The alpha component specifies    the transparency of a pixel. 0
  691.       means    completely transparent and 255 means opaque. The alpha
  692.       component is ignored if you do not enable alpha buffer mode.
  693.  
  694.       The alpha buffer is used to set a mask when a    QImage is
  695.       translated to    a QPixmap.
  696.  
  697.       See also: hasAlphaBuffer() and createAlphaMask().
  698.  
  699.      vvvvooooiiiidddd QQQQIIIImmmmaaaaggggeeee::::::::sssseeeettttCCCCoooolllloooorrrr (((( iiiinnnntttt iiii,,,, QQQQRRRRggggbbbb cccc ))))
  700.       Sets a color in the color table at index _i to    _c.
  701.  
  702.       A color value    is an RGB triplet. Use the qRgb    function
  703.       (defined in qcolor.h)    to make    RGB triplets.
  704.  
  705.       See also: color().
  706.  
  707.       Examples:  desktop/desktop.cpp
  708.  
  709.      vvvvooooiiiidddd QQQQIIIImmmmaaaaggggeeee::::::::sssseeeettttNNNNuuuummmmCCCCoooolllloooorrrrssss (((( iiiinnnntttt nnnnuuuummmmCCCCoooolllloooorrrrssss ))))
  710.       Resizes the color table to _n_u_m_C_o_l_o_r_s colors.
  711.  
  712.       If the color table is    expanded, then all new colors will be
  713.       set to black (RGB 0,0,0).
  714.  
  715.       See also: color() and    setColor().
  716.  
  717.      vvvvooooiiiidddd QQQQIIIImmmmaaaaggggeeee::::::::sssseeeettttPPPPiiiixxxxeeeellll (((( iiiinnnntttt xxxx,,,, iiiinnnntttt    yyyy,,,, uuuuiiiinnnntttt    iiiinnnnddddeeeexxxx____oooorrrr____rrrrggggbbbb ))))
  718.       Sets the pixel index or color    at the given coordinates.
  719.  
  720.  
  721.  
  722.  
  723.      Page 11                         (printed 9/22/98)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))       QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))
  731.  
  732.  
  733.  
  734.       If (x,y) is not valid, or if the image is a paletted image
  735.       (depth() <= 8) and _i_n_d_e_x__o_r__r_g_b >= numColors(), the results
  736.       are undefined.
  737.  
  738.      QQQQSSSSiiiizzzzeeee QQQQIIIImmmmaaaaggggeeee::::::::ssssiiiizzzzeeee    (((()))) ccccoooonnnnsssstttt
  739.       Returns the size of the image.
  740.  
  741.       See also: width(), height() and rect().
  742.  
  743.      QQQQIIIImmmmaaaaggggeeee QQQQIIIImmmmaaaaggggeeee::::::::ssssmmmmooooooootttthhhhSSSSccccaaaalllleeee    (((( iiiinnnntttt wwwwiiiiddddtttthhhh,,,, iiiinnnntttt hhhheeeeiiiigggghhhhtttt    )))) ccccoooonnnnsssstttt
  744.       Returns a copy of the    image smoothly scaled to _w_i_d_t_h by
  745.       _h_e_i_g_h_t pixels. For 32-bpp images, and    1-bpp/8-bpp color
  746.       images, the result will be 32-bpp, while all-gray images
  747.       (including black-and-white 1-bpp) will produce 8-bit
  748.       grayscale images with    the palette spanning 256 grays from
  749.       black    to white.
  750.  
  751.       This function    uses code based    on:
  752.  
  753.       pnmscale.c - read a portable anymap and scale    it
  754.  
  755.       Copyright (C)    1989, 1991 by Jef Poskanzer.
  756.  
  757.       Permission to    use, copy, modify, and distribute this
  758.       software and its documentation for any purpose and without
  759.       fee is hereby    granted, provided that the above copyright
  760.       notice appear    in all copies and that both that copyright
  761.       notice and this permission notice appear in supporting
  762.       documentation. This software is provided "as is" without
  763.       express or implied warranty.
  764.  
  765.      QQQQIIIImmmmaaaaggggeeee::::::::EEEEnnnnddddiiiiaaaannnn QQQQIIIImmmmaaaaggggeeee::::::::ssssyyyysssstttteeeemmmmBBBBiiiittttOOOOrrrrddddeeeerrrr(((()))) [[[[ssssttttaaaattttiiiicccc]]]]
  766.       Determines the bit order of the display hardware. Returns
  767.       QImage::LittleEndian (LSB first) or QImage::BigEndian    (MSB
  768.       first).
  769.  
  770.      QQQQIIIImmmmaaaaggggeeee::::::::EEEEnnnnddddiiiiaaaannnn QQQQIIIImmmmaaaaggggeeee::::::::ssssyyyysssstttteeeemmmmBBBByyyytttteeeeOOOOrrrrddddeeeerrrr(((()))) [[[[ssssttttaaaattttiiiicccc]]]]
  771.       Determines the host computer byte order. Returns
  772.       QImage::LittleEndian (LSB first) or QImage::BigEndian    (MSB
  773.       first).
  774.  
  775.      bbbboooooooollll QQQQIIIImmmmaaaaggggeeee::::::::vvvvaaaalllliiiidddd    (((( iiiinnnntttt xxxx,,,, iiiinnnntttt yyyy )))) ccccoooonnnnsssstttt
  776.       Tests    if the ( _x, _y )    is a valid coordinate in the image.
  777.  
  778.       Examples:  qmag/qmag.cpp
  779.  
  780.      iiiinnnntttt QQQQIIIImmmmaaaaggggeeee::::::::wwwwiiiiddddtttthhhh (((()))) ccccoooonnnnsssstttt
  781.       Returns the width of the image.
  782.  
  783.       See also: heigth(), size() and rect().
  784.  
  785.      RRRREEEELLLLAAAATTTTEEEEDDDD FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  786.  
  787.  
  788.  
  789.      PPPPaaaaggggeeee 11112222                         ((((pppprrrriiiinnnntttteeeedddd 9999////22222222////99998888))))
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))       QQQQIIIImmmmaaaaggggeeee((((3333qqqqtttt))))
  797.  
  798.  
  799.  
  800.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ssss,,,,    ccccoooonnnnsssstttt QQQQIIIImmmmaaaaggggeeee &&&& iiiimmmmaaaaggggeeee))))
  801.       Writes an image to the stream    as a BMP image.
  802.  
  803.       See also: QImage::save().
  804.  
  805.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ssss,,,,    QQQQIIIImmmmaaaaggggeeee &&&& iiiimmmmaaaaggggeeee))))
  806.       Reads    an image from the stream.
  807.  
  808.       See also:  QImage::load().
  809.  
  810.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  811.       hhhhttttttttpppp::::////////wwwwwwwwwwww....ttttrrrroooollllllll....nnnnoooo////qqqqtttt////qqqqiiiimmmmaaaaggggeeee....hhhhttttmmmmllll
  812.  
  813.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  814.       Copyright 1992-1997 Troll Tech AS.  See the LICENSE file
  815.       included in the distribution for a complete license
  816.       statement.
  817.  
  818.      AAAAUUUUTTTTHHHHOOOORRRR
  819.       Generated automatically from the source code.
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.      Page 13                         (printed 9/22/98)
  856.  
  857.  
  858.  
  859.